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THE LATEST IN PROGRAMMING MICROCONTROLLERS 


l@ BY CHUCK HELLEBUYCK 


GETTING STARTED WITH THE 
PICBASIC™ PRO COMPILER AND 
MPLAB® IDE 


EMAIL FEEDBACK HAS MADE | LEAR THAT there are many who woul 


like me to qo Hack and cover how fo : i started, as the tile of the coliuli 
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changed, and there are still some beginner topics | have not covered 


Ne area missed is how to set up and use Microchip’s As | write this article, version 8.02 is the latest. The 
MPLAB IDE for developing your programs. If you MPLAB IDE download is a zip file that needs to be 
write in assembly, C, or even microEngineering Labs’ extracted into the directory of your choice. Once you 
PICBASIC or PICBASIC PRO compilers, you can use the have un-zipped the files, you will see a file named 
same MPLAB IDE. This is important to learn, especially for “Install MPLAB_v8.02.exe.” This is the installation setup 
those who may graduate from a hobbyist programmer to a_ | file that you need to run. Follow the installation procedure 
professional programmer. and let it install at the default directory. This will put the 
All Microchip tools work directly with the MPLAB IDE. MPLAB IDE and all of its components in the C:\Program 
This includes the PICkit™ 2 Starter Kit (Part #DV164120), Files\Microchip directory of your hard dlrive. 
which I’ve covered in many articles before and | plan to use Next, download the PICBASIC PRO compiler demo 
again as the hardware. For the software, | decided to keep version into a directory on your hard drive. This includes 
it simple and inexpensive by using the sample version of an installation file called “PBPDEMO3.EXE.” Run this file 
the PICBASIC PRO compiler. This is the Basic language and let it install at the default directory, which will be 
compiler I’ve written about many times before. After all, the located at C:\PBPDEMO, 
BASIC acronym stands for “Beginner's All-purpose Symbolic —_ | Next, download the file called “PBPlugins.bat.” This 
Instruction Code.” The keyword, here, is beginner. file is strictly for the MPLAB-PBPRO connection. You can 
The sample version of the PICBASIC PRO compiler is get this program from the http://melabs.com/support/ 
available as a free download from http://melabs.com/pbpde mplab.htm page, along with details on how to use the 
mo.htm, and the MPLAB IDE is available as a free download PICBASIC PRO compiler with the MPLAB IDE. I'm telling 
from www.microchip.com/mplab. The PICkit 2 Starter Package you my way of doing this because | found one little glitch 
will cost you $49.99 plus shipping if you purchase it from that | could not get around, and | suspect you'll run into 
www.microchipdirect.com, but you can get it for the same the same thing. Run the PBPlugins.bat program. The 
price from Mouser or any other catalog source. The starter instructions at microEngineering Labs’ mplab.htm Web 
package includes a PIC16F690 microcontroller (MCU), so the page explain how to update the search path for the 
free compiler and IDE downloads (plus the starter package) version of Microsoft Windows® you are running. Follow 
will give you everything you need to start programming. If you those instructions and update the search paths. 
want to follow along with this article, you'll need these items. Next is the trick | recommend for getting around the 


glitch | ran into. Go to the C:\PBPDEMO directory and 
you will see three folders — INC, MCS, and SAMPLES. Acld 


INSTALLATION | 


The MPLAB IDE is a very powerful tool, with a lot of jogo; MBLAB. and PiG-ace reuisiane 
features. | will go over the essentials you'll need to know ng, nthe. Ue cir ung F 


in order to get started quickly. 
First, download the latest release of the MPLAB IDE. 
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a new directory called PFILES. Now, go to the directory 
where the MPLAB IDE is stored (C:\Program Files\ 
Microchip\MPASM Suite) and you will see a bunch of files 
that start with a “P” and end with an “.inc.” These include 
the files the compiler will look for and, for some reason, | 
coulc not get the MPLAB/PICBASIC PRO combination to 
fine them. | even changed all the recommended path 
ste!ements shown on microEngineering Labs’ MPLAB 
instruction page and it still could not find them. You can 
copy all those Pxxx.inc files into the PFILES directory that 
you made, but | suggest you just copy the list below: 


P12F683.INC P16F871.INC 
P16F84.INC P16F872.INC 
P16F84A.INC P16F873.INC 
P16F627.INC P16F873A.INC 
P16F627A.INC P16F874.INC 
P16F628.INC P16F874A.INC 
P16F628A.INC P16F876.INC 
P16F688.INC P16F876A.INC 
P16F690.INC P16F877.INC 
P16F870.INC P16F877A.INC 


This list includes all the MCUs supported by the PICBASIC 
PRO sample version, which will make it easier to find these 
files later when we create a project in the MPLAB IDE. 


Now that everything is installed, we need to set up 


the MPLAB IDE to recognize the PICBASIC PRO compiler. 


1) Start MPLAB and select “Set Language Tool Locations” 
under the Project menu. 

2) Select the “PICBASIC PRO Toolsuite” name. 

3) Use the browse button to select PBPDEMOW.EXE in the 
PBPDEMO directory where the PICBASIC PRO Demo 
version was installed. 


Figure 1 shows the window you should see 
when you complete these steps. By choosing 
this path, you are indicating to the MPLAB IDE 
where the PICBASIC PRO compiler is located 
on your hard drive. Click on the OK button to 
accept this, and you are now ready to use the 
MPLAB IDE with the PICBASIC PRO demo 
version. If you have the full version of PICBASIC 
PRO, all the steps are the same except the 
PICBASIC PRO will be installed in the C:\PBP 
directory, and the file you select in the browse | 
window is PBPW.EXE. | 


FIRST PROJECT 


Set Language Tool Locations 


r Registered Tools ~ 
| | — IAR Systems Midrange 
+) Mictochip 4SM30 Toolsuite 
+ Microchip C17 Toolsuite 
+ Microchip C18 Toolsuite 
+ Microchip C30 Toolsuite 


| Microchip MP4&SM Toolsuite 
+ Microchip PICS2 4ssermbler Toolsuite 


in the MPLAB IDE. Click on the MPLAB Project menu and 
select the Project Wizard. You will be walked through sev- 
eral windows, which take you through the following steps: 


1) Select a device. Choose the PIC16F690, as that is the 
part included in the PICkit 2 Starter Kit. 


2) Select a language tool suite. Choose the PICBASIC PRO 
tool suite. 


3) Create a new project. Use the browse button, and 
select the directory where you want to store the project 
and all of the files. | suggest you create it as close to C: as 
possible, to keep the path name short. Figure 2 shows my 
project, entitled “16F690_Blink” in the PBPCode directory 
that | created at the root. 


4) Add existing files to your project. This is where you may 
select one of the PICBASIC PRO sample files that you 
wish to use or modify, or maybe an older file that you 
wrote. For this example, select the BLINK.BAS file in the 
PBPDEMO/SAMPLES directory. Highlight it, and then click 
on the Add>> button. 


use a trick that | found — change to the PFILES directory 
you created and select the P16F690.INC file. Then, click 
the Add>> button to add it to the project, as well. This will 
save you an error later. Finally, next to each file, you will 
see a big “A.” Click on that A until it changes to a C. This 
will automatically copy these files to your project directory. 
Figure 3 shows what your screen should look like. 


5) At this point, you're done so click the FINISH button. 


FIRST PROGRAM 


Odds are that your MPLAB screen is now blank. If so, 


@ FIGURE 1. PICBASIC PRO Language Selection 


Microchip PIC32 C-Compiler T oolsuite 
microEngineering PicBasic Pro Toolsuite 
©! Executables 
microEngineering PicBasic Pro Compiler (pbpw.exe} 


bane —. 


[ Location = | 


] 
Now, you are ready to build your first project. [CAPBPDEMO\PBPWOEMO.EXE if Browse... Browse... ] 


In the MPLAB IDE, all the software files you create 


will be connected by a project structure. The easiest Help 


way to do this is to use the Project Wizard utility 


OK | Cancel _ | Apply _| 
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Project Wizard 


Step Three: 
Create a new project, or reconfigure the active project? 


@ Create New Project File — 


[CAPBPCode\1 5F690_Blink 


o Savent 


< Back | Next > | Cancel | 


BH FIGURE 2. Step Three of Project Creation 

you need to click on the VIEW menu and select the 
PROJECT and OUTPUT windows. By clicking on these, a 
check mark will show up next to the menu selection, 
and the windows will appear in the MPLAB IDE with the 
project files shown in the Project window. The Output 
window will be blank. Figure 4 shows the final view. The 
BLINK.BAS and P16F690.INC files are listed and can be 
opened by double clicking on them. To actually run the 
BLINK.BAS file on the PICI6F690 MCU, we need to 
modify the basic file slightly. The sample file is written to 
work on the PORTB register, and we need to drive the 
PORTC pins. | modified the sample program to look like 
Listing 1. This is really a simple program, which makes it 
easier to prove out all the steps to get your first program 
@ FIGURE 3. Step Four of Project Creation 


Project Wizard 


Step Four: 
Add existing files to your project 


( Prer627INC 
(2) PISFE27A INC 
PIGF628,INC 
PISF6284, INC 
(2) P16Fe88.INC 
B 
fA) PISF84.INC 

(2) PIsFed4.INC 
(2) PIsF870.1NC 
(©) PIsFe71.INC 
(2) P16F872INC 


(ER PIeFe73INC 8 
ers: 


= Remove | 
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Browse... | 


as | C PI6FES0.INC | C:\PBPDEMO\FFI 


C BLINK.BAS | C:\PBPDEMO\SAMI 


< Back Cancel | 


x] working. At the top of the program, though, 
are a few statements that might confuse the 
beginner. These are shown below: 


ANSEL = 0 ‘ Intialize A/D ports off 
CMICOND = 0 Initialize Comparator | off 
CM2COND = 0 ‘ Initialize Coparator 2 off 


These ‘statements are required for using 
the PIC16F690 MCU’s I/O as digital pins. The 
PIC16F690, like many other PIC MCUs, multi- 
plexes the pin connections with other features. 
The PICT6F690 MCU has both Analog-to-Digital 
Converter (ADC) ports and comparators that 
share the actual pin connections with the digital 
\/O circuitry. To use the digital 1/O pins, you 
must make sure the ADC and comparators are 
disconnected. For this project, we'll disconnect 
them by clearing the bits in these registers — 
Analog Select Register (ANSEL), Comparator 1 
Control Register (CM1CONO), and Comparator 
2 Control Register (CM2CONO). 

The rest of the program is just a High, Low, and 
Pause loop that acts on the PORTC pin, RCO. This pin is 
connected to the DS1 LED on the PICkit 2 starter board. 
By flipping the level on the RCO pin from high to low with 
a pause in between and looping through that sequence 
multiple times, we make the LED flash. 

Once the program is written, simply press the F10 
button to compile the PICBASIC PRO file into a binary 
-hex file. If everything compiles without errors, you will 
see a “Build Succeeded” message in the output window. 
If you receive an error message, it will tell you in which 
line of code it is so that you can see what typo you may 
have accidentally made. 


PROGRAMMING THE PIC1GF690 MCU 


Now that we have a binary .hex file, we neecl 
to load it into the PIC16F690 MCU so that it can 
run. For this, | will use the PICkit 2 Starter Kit (see 
Figure 5), with the PICkit 2 Programmer connected 
to the PC’s USB port. The PICkit 2 Programmer 
will then power the development board from the 
USB port and program the PIC16F690 MCU 
when inserted into its socket through the board’s 
programming connecter. Because the MCU is 
connected to the LEDs, switch, and poten- 
tiometer on the development board, we will 
use the In-Circuit Serial Programming™ feature 
to download the .hex file into the PIC16F690 
MCU. This just means that you don’t have to 
remove the MCU in order to program it. 

To move forward from this point, we need 
to connect the PICkit 2 Programmer to the 
USB port and then enable the programmer in 
the MPLAB IDE. We clo so by selecting the 
PICKit 2 from the “Programmer” menu at the 
top of the MPLAB screen (see Figure 6). 


Help 


& FIGURE 4, The MPLAG IDE Winciow 


The output window will gain a 
PICkit 2 tab and show the status of 
the PICkit 2 Programmer. You should 
see the following text displayed in the 
output window: 


Found PICkit 2 - Operating System 
Version 2.20.0 

Target power not detected - Powering 
from PICkit 2 

PIC16F690 found (Rev 0x4) 

PICkit 2 Ready 


The message will indicate the 
operating system in the PICkit 2 
Programmer, where the development 
board is receiving power from, and 
which MCU it detected. After this, a 
message stating the PICkit 2 is ready 
to program will be displayed. At the 
top right of the MPLAB window, the 
control buttons for the PICkit 2 Programmer should also 
appear, as shown in Figure 7. These buttons allow you to: 


1) Program the complete part. 

2) Read program memory. 

3) Read EEPROM. 

4) Verify that the program inside matches what you 
programmed. 

5) Erase the complete device. 

6) Verify that the complete device is erased. 


You also have control over the MCLR reset line on 
the MCU, which are the rising- and falling-edge icons. By 
clicking on the rising-edge icon, you allow the PIC16F690 
MCU to run the program. The last icon is a miniature 
PICkit 2, which just allows you to re-check the status of 
the programmer. 

To load the BLINK.hex file into the PIC16F690 MCU, 
simply click on the first icon button and the PICkit 2 
Programmer will handle the rest. You will see the status 
in the PICkit 2 output window. It will first erase the 
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MCU, and then program and verify it. After this, the 
programmer is ready to run. Click on the rising-edge button 
to bring MCLR to VDD. The LED should start to flash. 


To get through all of this without errors is a very good 
start. However, chances are you might see a few errors, or 
get all the way to the end and find that the LED does not 
flash. I'll try to cover a few of the more common errors 
that the beginner might run into. The first involves the 
PICBASIC PRO compiler and the MPLAB IDE/Windows 
structure. For some reason, no matter how | changed the 
path structure in Windows or reset things in the MPLAB 
setup screens, | would encounter the error shown in 
Figure 8 when | first tried to run the PICBASIC PRO 
compiler in the MPLAB IDE. 

In fact, | received a whole list of errors that started 
with the line “Cannot open file ... PI6F690.INC.” This is 


LISTING 1: BLINK.BAS Sample Program 


* Example program from manual to blink and LED connected 
‘’ to PORTC.0 about once a second. 


ANSEL = 0 * Initialize A/D ports off 

CMICONO = 0 * Initialize Comparator1 off 

CM2CON0 = 0 * Initialize Comparator2 off 

loop: High PORTC.0 * Turn on LED connected to PORTC.0 
Pause 500 * Delay for 5 seconds 
Low PORTC.0 * Turn off LED connected to PORTC.0 
Pause 500 ‘ Delay for 5 seconds 
Goto loop ‘ Loop back and blink LED forever 
End 
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why | suggest you use the project wizard the first time you 
create a project, and include the P file for the part you are 
using to prevent this error from occurring. If you forget, 
you can add a copy of the P file later, but it has to be put 
into the same directory as the .bas file you created. 

Another beginner error that crops up often involves 
the configuration settings. Outside the structure of your 
program, the PIC16F690 MCU has certain bits that are 
set at program time to control the watchdog timer, the 
power-up timer, the oscillator selection, and more. All 
of the options for the part can be seen by clicking on the 
Configure>Configuration bits menu selection in the MPLAB 
IDE (see Figure 9). You can manually select the options, or 
click on the little box in the upper-left corner to allow the 
compiler to set these in code. 

| recommend that you set the options in code, because 
they will then be embedded in the .hex file used to program 
the MCU. The PICBASIC PRO compiler puts that configu- 
ration setup in a separate file that it calls at compile time. 
The setup will be in an .inc file that has the name of the 


Ma Output 


F\PBPW EXE” -ampasmwin -0q -2 ~p16F690 "stopwatch bas” 
© SPBPN16F690 INC zt 
C \PBPN16F690 INC 22 


ereny not previously detained (_I 
C SPBPNI6F690 INC 


a Synbot not previously defined (_UDT_OM) 

C SPBELER690 IM Synbal not previously defined (— NCLRE OFF) 
C PBR. 16F690. Inc 22 Syabol not previously defined (“CP_OFF) 

© \A+CODENPBPDEHO\STOPUATCH ASM 59 
C \AtCODE\PBPDENO\STOPYATCH ASH 61 
C SAPCODESPBPDEMCO’STOPYATCH ASM 62 
5 ae vin) PEPDEMO-STOPWATCH ASM 65 


APSPRPPTCIl TIR 2708 


Sumbhal ant nrevinusty defined (STATIS 
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Cannot open file (Include File "P16F690 Itc” not found) 
CSC_NOCLEOUT) 


Duplieste label (=. SORTL” or aos symbol that cannot be redet 
Symbol not prevsously detined (PORT! 

Syabol not previously defined (Thish) 
Syubol not prevaocusly det ined (TRISC) 


MCU you are using. In this case, the 
file is named 16F690.inc. You will find 
it in the PBP or PBPDEMO directory, 
where you installed the PICBASIC 
~PRO compiler. The file will contain a 
_config line, like the example below: 


__config _INTRC_OSC_NOCLKOUT & _WDT_ON 
& MCLRE ON & CP OFF 


This line in the 16F690.ine file is 
where the PICBASIC PRO compiler 
gets the information on how to set the 
configuration bits inside the .hex file. 
In this example, the internal RC 
oscillator is used as the system clock. 
This is what | recommend for the 
PIC16F690 MCU, but you can change 
it to an external oscillator if you need 
more accuracy. For the beginner, | 
would not worry about all of this — just 
know that it exists. However, if you find 
that your LED does not flash, then you 
might want to make sure the settings 
are adequate for what you need. For 
example, if you are developing on a 
board that has an external 20 MHz crystal and you keep 
finding that the program is running slow, you might have 
the internal oscillator set up in the configuration. 

One of the biggest errors I've seen with beginners is the 
exact opposite-they think they are using the internal oscillator, 
but the configuration is set to run from an external oscillator 
(i.e., .XT_OSC). The MCU won't run without a clock. 


CONCLUSION 


| covered a lot of ground in this article. However, if you 
use this setup and get that first LED to blink, you are ready 
to start creating more software programs without having 
to worry about all of the hardware setup connections. What 
| suggest you do is modify the PAUSE command value to 
get the LED to flash faster or slower. Then, perhaps try to 
duplicate the code and get it to flash a second LED. If you 
alternate the high and low commands, you can make the 
LEDs flash back and forth, like lights at a railroad crossing. 

Some readers have shared that they think my column 
is good, but they sometimes get lost trying to follow along. 
They feel I’m writing to a bunch 
of engineers, rather than to 
hobbyists. | understand this 
completely, however this is a 
normal reaction as my subject 
matter can seem complicated to 
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my previous columns, and 
suddenly all of the complicated 
stuff becomes easier. 

Another problem is that 
some readers are familiar with 
using little Basic modules that 
have all the inner details hidden 
from the user, in order to make 
things easier. You pay for that, though, by not having the 
ability to use all the features an MCU can offer. Many times, 
you sacrifice speed and memory space for simplicity, not to 
mention paying a lot more for the MCU. This will seem like 
a leap at first but, trust me, it’s not that tough. 

On the other side of the fence, | receive other 
comments stating that | often use too simple of an 
example — such as flashing an LED — to show how to get 
started (as I’ve done in this column). | will cover more 
complicated projects using this same MPLAB IDE, 
PICBASIC PRO compiler (sample version), and PICkit 2 
Starter Kit setup in future columns. The idea | have with 
this new approach to the beginner path is to use a com- 
mon, but powerful and professional set of development 
tools and software to create a step-by-step guide to getting 
started in programming. | plan to use this same setup in 
many future columns to remain consistent. | hope you'll 
continue to tune in. After readers get more comfortable 
with the PICBASIC PRO compiler, they can then advance 
to the full version or possibly convert to the C language. 
By then, my Beginner’s Guide to Embedded C Programming 
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book should be in print, and | can help you down that path. 

Please send your feedback on this particular article to me, 
so that | can determine how successful you were in getting 
all of this to work. My email address is chuck@elproducts.com. 
| try to answer all emails, but | sometimes find messages 
from readers caught in my spam filter. Please write “Nuts 
& Volts” or “N&V” in the subject line to help me find your 
email. Your feedback will enable me to explain the subject 
matter of my columns in more complete ways (there is 
only so much | can fit into a few Nuts & Volts pages). 

Additionally, if you get a chance, check out my new web- 
site dedicated to my books-www.elproducts.com. If you are 
a fan of my modules and other hardware, you can now buy 
them from my friends at www.beginnerelectronics.com. 

| hope you tune in to my next column (July ‘08 issue), 
where I'll show you how to use an ADC to read the 


potentiometer on the PICkit 2 development board. !!\v 


Order online at: 
www.melabs.com 


USB Programmer for PIC® MCUs 
$89. 95 {as shown) - 


RoHS 
Compliant 


Programs PIC 
MCUs including 
low-voltage (3.3V) 
devices 


Inctudes 
Software for 
Windows 

98, Me, NT, 
XP, and Vista 


With Accessories for $119.95: 
Includes Programmer, Software, USB Cable, 
and Programming Adapter for 8 to 40-pin DIP. 


EPIC™ Parallel 
Port Programmer 
starting at $59.95 


Development Tools for PIC® MCUs 
mictonginecring abs, ne 


_LAB-X Expornesiiet Boards 
Pre-Assembled Board 
Available for 8, 14. 18, 28, sere 
and 40-pin PIC® MCUs : 
2-line, 20-char LCD Module { * 
9-pin Serial Port ied 
Sample Programs 

Full Schematic Diagram 


Piaewin from $79.95 to $349.95 


PICPROTO™ Prototyping Boards 


Double-Sided with Piate-Thru Holes 
Circuitry for Power Supply and Clock 
Large Prototype Area 

Boards Available for Most PIC® MCUs 
Documentation and Schematic 


Pricing from $8.95 to $19.95 


Phone: (719) 520-5323 
Fax: (719) 520-1867 
Box 60039 
Colorado Springs, CO 80960 


BASIC Compilers for PICmicro® 
Easy-To-Use BASIC Commands 
Windows 98/Me/2K/XP/Vista 


PICBASIC™ Compiler $99.95 
“" BASIC Stamp 1 Compatible 
Supports most 14-bit Core PICs 
Built-in Serial Comm Commands 


PICBASIC PRO™ Compiler $249.95 
Supports most PiCmicro® MCU Families 
Direct Access to Internal Registers 
Supports In-Line Assembly Language 
Interrupts in PICBASIC and Assembly 
Built-In USB, 12C, RS-232 and More 
Source Level Debugging 


See our full range of products, including 
books, accessories, and components at: 


www.melabs.com 
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